virtual int DoModal( );

Возвращаемое значение
Значение int, которое определяет значение nResult параметра, который был передан к CDialog::EndDialog функции, который используется, чтобы закрыть диалоговое окно. Возвращаемое значение было бы -1, если функция не могла бы создавать диалоговое окно, или IDABORT, если некоторая другая ошибка произошла.

Замечания
Вызовите эту функцию, чтобы вызвать модальное диалоговое окно и возвращать результат диалогового окна когда выполнено. Эта функция обрабатывает все взаимодействие с пользователем, в то время как диалоговое окно активно. Это - то, что делает диалоговое окно модальным, то есть пользователь не может взаимодействовать с другими окнами, пока диалоговое окно не закрыто.
Если пользователь нажимает одну из кнопок в диалоговом окне, типа OK или Cancel, функции драйвера сообщения, типа OnOK или OnCancel вызваны к попытке, чтобы закрыть диалоговое окно. Значение по умолчанию OnOK функции - проверить правильность и модифицировать данные диалогового окна и закрывать диалоговое окно с результатом IDOK. Эначение по умолчанию OnCancel функции - закроет диалоговое окно с результатом IDCANCEL без того, чтобы подтвердить правильность или модифицировать данные диалогового окна. Вы можете перегружать эти функции драйвера сообщения, чтобы изменить их поведение.

Пример

void CTstApp::OnAppAbout()
{
   // Создать диалоговое окно, передающее 
   // ID ресурса шаблона диалога
   CDialog aboutDlg(IDD_ABOUTBOX);

   // Создайте и покажите диалоговое окно
   int nRet = -1;
   nRet = aboutDlg.DoModal();

   // Обработайте возвращаемое значение из DoModal
   switch ( nRet )
   {
   case -1: 
      AfxMessageBox("Dialog box could not be created!");
      break;
   case IDABORT:
      // Делайте что то.
      break;
   case IDOK:
      // Делайте что то.
      break;
   case IDCANCEL:
      // Делайте что то.
      break;
   default:
      // Делайте что то.
      break;
   };
}